Day 27: Restify —— 在Node.js中构建正确的REST Web服务

编者注：我们发现了有趣的系列文章《30天学习30种新技术》，正在翻译，一天一篇更新，年终礼包。下面是第 27 天的内容。

---

今天决定学一个叫做restify的Node.js模块。restify模块使得在Node.js中写正确的REST API变得容易了很多，而且它还提供了即装即用的支持，如版本控制、错误处理、CORS和内容协商。它大量地借鉴了Express（故意地），因为这或多或少是事实上的API来写在node.js上写web应用程序，将数据存储在MongoDB中。

Restify准备

Restify需要NodeJS和NPM包管理器，这个可以是随node.js安装时默认的。如果已经安装了node.js和NPM，就可以用NPM系统来安装Harp了。

此应用程序使用MongoDB作数据存储。

Restify安装

在任何方便的目录中的文件系统上创建一个新的目录：

$ mkdir myapp
$ cd myapp

输入下面命令，安装restify模块：

$ npm install restify

使用MongoJS作为MongoDB的驱动程序，输入下面命令安装mongojs模块：

$ npm install mongojs

编写基于REST的API

现在已经安装了restify和mongojs创建一个名为app.js的新文件：

$ touch app.js

把下面内容粘贴进app.js：

var restify = require('restify');
var mongojs = require("mongojs");

这是加载restify和mongojs模块，并给它们分配变量。

现在，创建一个使用restify API的新服务器：

var restify = require('restify');
var mongojs = require("mongojs");

var ip_addr = '127.0.0.1';
var port    =  '8080';

var server = restify.createServer({
    name : "myapp"
});

server.listen(port ,ip_addr, function(){
    console.log('%s listening at %s ', server.name , server.url);
});

createServer() 函数接受一个选择对象，将myapp作为选择对象的服务器的名称传递给它，也可以在这份文档中查看选项的完整的选项列表。创建服务器实例之后，通过端口、ip地址和一个回调函数调用listen函数。

运行程序：

$ node app.js

然后会看见如下命令行：

myapp listening at http://127.0.0.1:8080

配置插件

restify模块有很多内置的插件，把下面内容复制并粘贴到app.js，应该加在server.listen() 函数前面。请参阅这份文档以了解所有被支持的插件。

server.use(restify.queryParser());
server.use(restify.bodyParser());
server.use(restify.CORS());

上述代码表示：

1. restify.queryParser() 插件是用来解析HTTP查询字符串（如 /jobs?skills=java,mysql），解析后的内容将会在req.query里可用。
2. restify.bodyParser() 会在服务器上自动将请求数据转换为JavaScript对象。
3. restify.CORS() 配置应用程序中的CORS支持。

MongoDB的配置

在添加路由之前，添加代码来连接到MyApp的MongoDB数据库：

var connection_string = '127.0.0.1:27017/myapp';
var db = mongojs(connection_string, ['myapp']);
var jobs = db.collection("jobs");

现在，已经连接到本地MongoDB实例。接下来，需要得到使用数据库对象的工作集合。

写CRUD API

现在，服务器和数据库已经准备了。仍然需要路由来定义API的行为，复制并粘贴以下代码到app.js文件中：

var PATH = '/jobs'
server.get({path : PATH , version : '0.0.1'} , findAllJobs);
server.get({path : PATH +'/:jobId' , version : '0.0.1'} , findJob);
server.post({path : PATH , version: '0.0.1'} ,postNewJob);
server.del({path : PATH +'/:jobId' , version: '0.0.1'} ,deleteJob);

上述代码执行以下操作：

1. 当用户发出一个GET请求到'/jobs'，findAllJobs回调函数将被调用。
2. 当用户发出一个GET请求到'/ jobs/123'，findJob回调函数将被调用。
3. 当用户发出POST请求'/jobs'，postNewJob回调函数将被调用。
4. 当用户删除请求'/ jobs/123'，deleteJob回调会被调用（此处原文有误）。

现在编写回调函数，复制并粘贴进app.js：

function findAllJobs(req, res , next){
    res.setHeader('Access-Control-Allow-Origin','*');
    jobs.find().limit(20).sort({postedOn : -1} , function(err , success){
        console.log('Response success '+success);
        console.log('Response error '+err);
        if(success){
            res.send(200 , success);
            return next();
        }else{
            return next(err);
        }

    });

}

function findJob(req, res , next){
    res.setHeader('Access-Control-Allow-Origin','*');
    jobs.findOne({_id:mongojs.ObjectId(req.params.jobId)} , function(err , success){
        console.log('Response success '+success);
        console.log('Response error '+err);
        if(success){
            res.send(200 , success);
            return next();
        }
        return next(err);
    })
}

function postNewJob(req , res , next){
    var job = {};
    job.title = req.params.title;
    job.description = req.params.description;
    job.location = req.params.location;
    job.postedOn = new Date();

    res.setHeader('Access-Control-Allow-Origin','*');

    jobs.save(job , function(err , success){
        console.log('Response success '+success);
        console.log('Response error '+err);
        if(success){
            res.send(201 , job);
            return next();
        }else{
            return next(err);
        }
    });
}

function deleteJob(req , res , next){
    res.setHeader('Access-Control-Allow-Origin','*');
    jobs.remove({_id:mongojs.ObjectId(req.params.jobId)} , function(err , success){
        console.log('Response success '+success);
        console.log('Response error '+err);
        if(success){
            res.send(204);
            return next();      
        } else{
            return next(err);
        }
    })

}

使用curl测试Web服务，输入下面命令创建一个“job”：

$ curl -i -X POST -H "Content-Type: application/json" -d '{"title":"NodeJS Developer Required" , "description":"NodeJS Developer Required" , "location":"Sector 30, Gurgaon, India"}' http://127.0.0.1:8080/jobs

找到所有的“jobs”：

$ curl -is http://127.0.0.1:8080/jobs
HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: application/json
Content-Length: 187
Date: Sun, 24 Nov 2013 16:17:27 GMT
Connection: keep-alive

[{"title":"NodeJS Developer Required","description":"NodeJS Developer Required","location":"Sector 30, Gurgaon, India","postedOn":"2013-11-24T16:16:16.688Z","_id":"52922650aab6107320000001"}]

部署到云端

在应用程序部署到OpenShift之前，座以下几个设置：

1. 注册一个OpenShift帐户，它是完全免费的，可以分配给每个用户1.5 GB的内存和3 GB的磁盘空间。
2. 安装RHC客户端工具，需要有ruby 1.8.7或更新的版本，如果已经有ruby gem，输入 sudo gem install rhc ，确保它是最新版本。要更新RHC的话，执行命令 sudo gem update rhc，如需其他协助安装RHC命令行工具，请参阅该页面： https://www.openshift.com/developers/rhc-client-tools-install
3. 通过 rhc setup 命令设置您的OpenShift帐户，此命令将帮助你创建一个命名空间，并上传你的SSH keys到OpenShift服务器。

设置完成后，输入以下命令创建一个新的OpenShift应用程序：

$ rhc create-app day27demo nodejs-0.10 mongodb-2 --from-code https://github.com/shekhargulati/day27-restify-openshift-demo.git

它会完成所有的工作，从创建一个应用程序、建立公共DNS、创建私有的git仓库到最后使用代码从Github资源库部署应用程序。该应用程序可以在这里访问 http:// day27demo-{domain-name}.rhcloud.com//

今天就这些，欢迎反馈。

---

原文 Day 27: Restify--Build Correct REST Web Services in Node.js
翻译整理 SegmentFault